SGI Performance Co-Pilot 1.3

home *** CD-ROM | disk | FTP | other *** search

/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmchart.z.z / pmchart.z / pmchart

Wrap

Text File | 1997-04-03 | 65KB | 924 lines

PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) NNNNAAAAMMMMEEEE ppppmmmmcccchhhhaaaarrrrtttt - plot performance metrics against time SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ppppmmmmcccchhhhaaaarrrrtttt [----zzzz] [----tttt _d_e_l_t_a] [----hhhh _h_o_s_t] [----aaaa _a_r_c_h_i_v_e_L_i_s_t] [----cccc _c_o_n_f_i_g_f_i_l_e] [----nnnn _n_a_m_e_s_p_a_c_e] [----oooo _o_u_t_p_u_t_F_i_l_e] [----pppp _v_c_r_P_o_r_t] [----AAAA _a_l_i_g_n] [----LLLL _l_a_b_e_l_G_a_p] [----OOOO _o_r_i_g_i_n] [----SSSS _t_i_m_e] [----TTTT _t_i_m_e] [----ZZZZ _t_i_m_e_z_o_n_e] [----ppppffff _p_r_i_n_t_F_o_n_t] [----sssshhhh _s_a_m_p_l_e_H_i_s_t_o_r_y] [----vvvvhhhh _v_i_s_i_b_l_e_H_i_s_t_o_r_y] [----ddddcccc _c_o_l_o_r_l_i_s_t] [----ssssccccrrrroooolllllllliiiinnnntttteeeerrrrppppoooollllaaaatttteeee {TTTTrrrruuuueeee|FFFFaaaallllsssseeee}] [----sssstttt _t_o_l_e_r_a_n_c_e] [----mmmmiiiinnnnggggrrrraaaapppphhhhhhhheeeeiiiigggghhhhtttt _h_e_i_g_h_t] [----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y] [----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y] [----nnnnaaaammmmeeee _n_a_m_e] [----ttttiiiittttlllleeee _t_i_t_l_e] [----xxxxrrrrmmmm """"_r_e_s_o_u_r_c_e_N_a_m_e:::: _v_a_l_u_e"""" ...] [other standard X11 flags] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN ppppmmmmcccchhhhaaaarrrrtttt is a graphical tool for the Performance Co-Pilot (PCP) which allows interactive selection and plotting of performance metrics, independent of their source. If you have a common performance problem, such as CPU, network or disk saturation, you can use the View Selection dialog to quickly get started - from the main menu, select VVVViiiieeeewwwwssss////VVVViiiieeeewwww SSSSeeeelllleeeeccccttttoooorrrr, click on the area of performance you wish to monitor, and then click aaaappppppppllllyyyy. To monitor a remote host, simply use the option menu (labeled HHHHoooosssstttt in the View Selection dialog) to change to the desired host before selecting the view. The HHHHoooosssstttt option menu can be pre-configured with the hosts you most often want to monitor - see the description for the ppppmmmmUUUUsssseeeerrrrHHHHoooossssttttLLLLiiiisssstttt X11 application resource, below. As you become more familiar with ppppmmmmcccchhhhaaaarrrrtttt, you can configure your own charts ("Views") for the particular performance problems you are interested in monitoring, and customize these charts to suit the systems environment you usually work within. ppppmmmmcccchhhhaaaarrrrtttt can display charts on any XXXX(1) server. However, if the XXXX(1) display is not ``GL-Capable'', then the application resource ****uuuusssseeeeGGGGllll needs to be set to _F_a_l_s_e. This can be done from the command line, e.g. ppppmmmmcccchhhhaaaarrrrtttt ----xxxxrrrrmmmm """"****uuuusssseeeeGGGGllll:::: FFFFaaaallllsssseeee"""" or by putting the following line into the user's resource database (usually by editing ~~~~////....XXXXrrrreeeessssoooouuuurrrrcccceeeessss) PPPPmmmmCCCChhhhaaaarrrrtttt****uuuusssseeeeGGGGllll:::: FFFFaaaallllsssseeee Normally, ppppmmmmcccchhhhaaaarrrrtttt operates in ``live'' mode where performance metrics are fetched in real-time and plotted against a time axis. The user can choose performance metrics and monitor the current values for these metrics on accessible internet hosts which are running the PCP collector software (see ppppmmmmccccdddd(1)). ppppmmmmcccchhhhaaaarrrrtttt can also replay archives of performance metrics (see ppppmmmmllllooooggggggggeeeerrrr(1)) and allow the user to interactively control the current replay time and rate using a VCR paradigm. This is particularly useful for retrospective comparisons and for post-mortem analysis of performance problems where a remote system is not accessible or a performance analyst is not available on-site. PPPPaaaaggggeeee 1111 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) All metrics in the Performance Metrics Name Space (PMNS) with numeric value semantics can be graphed and metrics from multiple hosts may be plotted on a common time axis. ppppmmmmcccchhhhaaaarrrrtttt examines the semantics of selected metrics and where sensible, converts fetched metric values to a rate before plotting. In the case where different metrics are plotted in the same chart (i.e. against a common Y-axis), ppppmmmmcccchhhhaaaarrrrtttt may also scale metric values where necessary, to produce comparable values with common units and scale. By default ppppmmmmcccchhhhaaaarrrrtttt will initially allow the user to select metrics to be plotted from the local host, however the graphical user interface allows other hosts or archives to be chosen at any time as new sources of performance metrics. MMMMOOOOUUUUSSSSEEEE CCCCOOOONNNNTTTTRRRROOOOLLLLSSSS ppppmmmmcccchhhhaaaarrrrtttt uses the left and right mouse buttons as follows; LLLLeeeefffftttt MMMMoooouuuusssseeee Apart from interacting with the menus and dialogs, the left mouse button is also used to select the current chart by clicking anywhere on the desired chart. At all times the current chart has a border drawn around the graph area and the legend (if visible) is rendered in red. MMMMiiiiddddddddlllleeee MMMMoooouuuusssseeee The middle mouse button is not used. RRRRiiiigggghhhhtttt MMMMoooouuuusssseeee The right mouse button is used to display metric values in a pop- up dialog. Clicking the right mouse in the graph drawing area of any chart displays information about the nearest metric and it's value, as plotted, at that point. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS The command line options for ppppmmmmcccchhhhaaaarrrrtttt roughly correspond with the application resources (see following Section). The ----SSSS, ----TTTT, ----OOOO and ----AAAA options may be used to define a time window to restrict the samples retrieved, set an initial origin within the time window, or specify a ``natural'' alignment of the sample times; refer to ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3) for a complete description of these options. ----zzzz Initially use the local timezone at the host that is the source of the performance metrics, as identified via either the ----hhhh or ----aaaa options. The default is to initially use the timezone at the local host. ----tttt _d_e_l_t_a Set the delay between chart updates to _d_e_l_t_a seconds. The default is specified in the application resource ppppmmmmUUUUppppddddaaaatttteeeeIIIInnnntttteeeerrrrvvvvaaaallll. This can be changed at run-time from the OOOOppppttttiiiioooonnnnssss////SSSShhhhoooowwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll dialog. PPPPaaaaggggeeee 2222 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) ----hhhh _h_o_s_t Causes the metric selection dialog (see NNNNeeeewwww CCCChhhhaaaarrrrtttt below) to initially connect to _h_o_s_t rather than the local host. Also see the application resources ppppmmmmHHHHoooossssttttNNNNaaaammmmeeee and ppppmmmmUUUUsssseeeerrrrHHHHoooossssttttLLLLiiiisssstttt. ----aaaa _a_r_c_h_i_v_e_L_i_s_t Initially opens the _a_r_c_h_i_v_e_L_i_s_t archive file(s), comprising a comma separated list of archive file names. The starting time is set to the earliest starting time of all archives in the list and the current archive (in the MMMMeeeettttrrrriiiicccc SSSSeeeelllleeeeccccttttiiiioooonnnn and VVVViiiieeeewwww SSSSeeeelllleeeeccccttttiiiioooonnnn dialogs is initialized to be the first archive in aaaarrrrcccchhhhiiiivvvveeeeLLLLiiiisssstttt.... Also see the application resource ppppmmmmLLLLooooaaaaddddAAAArrrrcccchhhhiiiivvvveeee. ----cccc _c_o_n_f_i_g_f_i_l_e Load _c_o_n_f_i_g_f_i_l_e as the starting configuration ("View") of charts. If _c_o_n_f_i_g_f_i_l_e is - or _s_t_d_i_n then ppppmmmmcccchhhhaaaarrrrtttt will read from it's standard input. This is useful for scripts and other applications which need to display a ``canned'' set of charts. If _c_o_n_f_i_g_f_i_l_e is not in the current directory and it doesn't start with .... or //// then ppppmmmmcccchhhhaaaarrrrtttt will also search for a file of the same name first in the user view directory (default $$$$HHHHOOOOMMMMEEEE////....ppppccccpppp) and failing that, in the system view directory (default ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmcccchhhhaaaarrrrtttt) Also see the application resource ppppmmmmLLLLooooaaaaddddFFFFiiiilllleeee, and the section titled CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE SSSSYYYYNNNNTTTTAAAAXXXX. The easiest way to create a suitable _c_o_n_f_i_g_f_i_l_e is to interactively create the required charts, save the chart configuration using VVVViiiieeeewwwwssss////VVVViiiieeeewwww SSSSaaaavvvveeee, and then edit the resulting save file (look for it in ~~~~////....ppppccccpppp////_f_i_l_e_n_a_m_e). ----nnnn _n_a_m_e_s_p_a_c_e Use _n_a_m_e_s_p_a_c_e rather than the default PMNS. This can not be changed at run-time. Also see the application resource ppppmmmmNNNNaaaammmmeeeeSSSSppppaaaacccceeee. ----oooo _o_u_t_p_u_t_F_i_l_e In this mode, ppppmmmmcccchhhhaaaarrrrtttt will not display anything, but rather create a set of charts and then save a snapshot image in the file _o_u_t_p_u_t_F_i_l_e in GIF format. If _o_u_t_p_u_t_F_i_l_e is - or _s_t_d_o_u_t then the output is sent to the standard output stream. This non- interactive mode is useful for generating charts from scripts for automatic inclusion in web documents, or whatever. The ----oooo option requires ----cccc for the the view to create. In archive mode (----aaaa is given) ppppmmmmcccchhhhaaaarrrrtttt generates _o_u_t_p_u_t_F_i_l_e, and then exits; this mode is usually run periodically from ccccrrrroooonnnnttttaaaabbbb(1) using ccccrrrroooonnnn....ppppmmmmssssnnnnaaaapppp(1) and a set of archive logs under the management of ccccrrrroooonnnn....ppppmmmmddddaaaaiiiillllyyyy(1). In live mode (----hhhh is given or neither ----aaaa or ----hhhh is given), ppppmmmmcccchhhhaaaarrrrtttt creates or overwrites _o_u_t_p_u_t_F_i_l_e every time the charts scroll (i.e. on every update); the minimum (and default) update interval in this mode is _3_0 _s_e_c_o_n_d_s. This may be changed with the ----tttt option, as described below. Normally, ----LLLL, ----SSSS, ----vvvvhhhh, ----sssshhhh and ----ggggeeeeoooommmmeeeettttrrrryyyy would also be specified on the command line to affect the appearance of the generated image. In archive mode, often the ----OOOO option is also used with the argument -_0 in order to display PPPPaaaaggggeeee 3333 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) the most recent data up to the current end of the archive. The size of the generated image will be slightly smaller than the the size requested with the ----ggggeeeeoooommmmeeeettttrrrryyyy option. This is because not all of the ppppmmmmcccchhhhaaaarrrrtttt main window is included in the snapshot, e.g. the menu bar is excluded. Also, if the requested height is less than that required to satisfy the ----mmmmiiiinnnnggggrrrraaaapppphhhhhhhheeeeiiiigggghhhhtttt setting, then the height is silently increased as required. ----pppp _v_c_r_P_o_r_t This option is normally used when ppppmmmmcccchhhhaaaarrrrtttt is launched as a time synchronized child from another tool. Rather than create a new time control connection, ppppmmmmcccchhhhaaaarrrrtttt will attempt to connect to an existing time controller on the port named _v_c_r_P_o_r_t, which should be a path to a UNIX domain socket in the file system. ----LLLL _l_a_b_e_l_G_a_p When ----oooo is used, ----LLLL forces _l_a_b_e_l_G_a_p ticks on the time-scale between labels. This is useful for labeling the time-scale with easily readable real-time events, e.g. ----LLLL _4 ----tttt _1_5_m_i_n ----AAAA _1_h_o_u_r_P forces hourly labels with four, 15 minute ticks between each label. The default label gap is determined dynamically, depending on tick density, main window geometry and assorted other factors. ----ZZZZ _t_i_m_e_z_o_n_e Initially use _t_i_m_e_z_o_n_e when displaying the date and time. _T_i_m_e_z_o_n_e is in the format of the environment variable TTTTZZZZ as described in eeeennnnvvvviiiirrrroooonnnn(5). ----ppppffff _p_r_i_n_t_f_o_n_t Use the Postscript font named _p_r_i_n_t_f_o_n_t when printing charts. The default, if neither the ----ppppffff command line option nor the ppppmmmmPPPPrrrriiiinnnnttttFFFFoooonnnntttt application resource are specified, uses a font which roughly matches the fonts used in the charts. These are in turn controlled by the application resources xxxxrrrrttttLLLLeeeeggggeeeennnnddddFFFFoooonnnntttt and xxxxrrrrttttAAAAxxxxiiiissssFFFFoooonnnntttt. See the application defaults file ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp---- ddddeeeeffffaaaauuuullllttttssss////PPPPmmmmCCCChhhhaaaarrrrtttt to discover the names of the fonts available. ----sssshhhh _s_a_m_p_l_e_H_i_s_t_o_r_y ----vvvvhhhh _v_i_s_i_b_l_e_H_i_s_t_o_r_y ppppmmmmcccchhhhaaaarrrrtttt maintains a history of _s_a_m_p_l_e_H_i_s_t_o_r_y metric values, of which _v_i_s_i_b_l_e_H_i_s_t_o_r_y are visible at any time. Although _v_i_s_i_b_l_e_H_i_s_t_o_r_y can be changed at run-time (see OOOOppppttttiiiioooonnnnssss////SSSShhhhoooowwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll below) to control the time duration (or ``window'') of the charts, _s_a_m_p_l_e_H_i_s_t_o_r_y can not be changed at run-time. The defaults for these arguments are specified in the ppppmmmmSSSSaaaammmmpppplllleeeeHHHHiiiissssttttoooorrrryyyy and ppppmmmmVVVViiiissssiiiibbbblllleeeeHHHHiiiissssttttoooorrrryyyy application resources. If _v_i_s_i_b_l_e_H_i_s_t_o_r_y is greater than _s_a_m_p_l_e_H_i_s_t_o_r_y, then _s_a_m_p_l_e_H_i_s_t_o_r_y is silently increased to equal _v_i_s_i_b_l_e_H_i_s_t_o_r_y. ----ddddcccc _c_o_l_o_r_l_i_s_t Use the comma or space separated list of color names specified in _c_o_l_o_r_l_i_s_t as the default color scheme (i.e. colors to be used in PPPPaaaaggggeeee 4444 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) plots where no explicit color has been given). E.g. ppppmmmmcccchhhhaaaarrrrtttt ----ddddcccc """"rrrreeeedddd,,,,ggggrrrreeeeeeeennnn,,,,bbbblllluuuueeee,,,,####ffffffff3333333300000000"""" When all colors in _c_o_l_o_r_l_i_s_t have been used for a particular chart, subsequent plots will cycle through the colors again. The default _c_o_l_o_r_l_i_s_t specified in the application defaults contains 12 colors corresponding to sequentially opposite corners of the hsv color cube. The application resource corresponding to this option is ppppmmmmDDDDeeeeffffaaaauuuullllttttCCCCoooolllloooorrrrssss. The default color scheme is called #- _c_y_c_l_e. The Section below titled CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE SSSSYYYYNNNNTTTTAAAAXXXX describes how use custom color schemes in ppppmmmmcccchhhhaaaarrrrtttt configuration files. ----ssssccccrrrroooolllllllliiiinnnntttteeeerrrrppppoooollllaaaatttteeee {TTTTrrrruuuueeee|FFFFaaaallllsssseeee} Affects scrolling behavior when there are long fetch latencies either due to a slow network connection or the ppppmmmmccccdddd(1) agent is slow to respond. When the update interval is less than the fetch latency then multiple scrolling may be required to keep up with real-time. If the option argument to ----ssssccccrrrroooolllllllliiiinnnntttteeeerrrrppppoooollllaaaatttteeee is FFFFaaaallllsssseeee (the default) then ``holes'' are plotted for the extra scrolled points. If TTTTrrrruuuueeee, then the most recently fetched values are ``scrolled-in''. When replaying an archive this option has no effect because multiple scrolling is never required. The corresponding application resource is ppppmmmmSSSSccccrrrroooollllllllIIIInnnntttteeeerrrrppppoooollllaaaatttteeee. ----mmmmiiiinnnnggggrrrraaaapppphhhhhhhheeeeiiiigggghhhhtttt _h_e_i_g_h_t Causes the minimum allowable height of the graph area in all charts to be _h_e_i_g_h_t. All charts have the same graph area height but may have different overall heights depending on the height of the legend. The default is specified in the application resource ppppmmmmMMMMiiiinnnnGGGGrrrraaaapppphhhhHHHHeeeeiiiigggghhhhtttt. ----sssstttt _t_o_l_e_r_a_n_c_e When ppppmmmmcccchhhhaaaarrrrtttt is started and more than one archive is named on the command line, if the difference in the starting times of one or more archives exceeds _t_o_l_e_r_a_n_c_e percent of the visible history (see ----vvvvhhhh) then a warning message is generated. The most common scenario for this to occur is when ppppmmmmcccchhhhaaaarrrrtttt is used to record an archive folio for multiple hosts, but one or more of these hosts does not have a synchronized clock (see ttttiiiimmmmeeeedddd(1) for details about how to synchronize the clocks on the machines on the local area network). The corresponding application resource is ppppmmmmCCCClllloooocccckkkkSSSSkkkkeeeewwwwTTTToooolllleeeerrrraaaannnncccceeee. ----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y ----nnnnaaaammmmeeee _n_a_m_e ----ttttiiiittttlllleeee _t_i_t_l_e PPPPaaaaggggeeee 5555 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) ----xxxxrrrrmmmm _r_e_s_o_u_r_c_e_N_a_m_e: _v_a_l_u_e Most standard XXXX(1) command line arguments may be used. MMMMEEEENNNNUUUUSSSS There are three main menus in ppppmmmmcccchhhhaaaarrrrtttt's user interface which control recording archives and printing charts (FFFFiiiilllleeee), allow pre-defined or previously saved "Views" to be displayed (VVVViiiieeeewwwwssss), change various options for currently displayed charts (EEEEddddiiiitttt) and change various global options (OOOOppppttttiiiioooonnnnssss). The EEEEddddiiiitttt menu also allows custom charts to be created. There is detailed on-line help available in ppppmmmmcccchhhhaaaarrrrtttt and hence the following provides only a brief description of each menu function. FFFFiiiilllleeee////RRRReeeeccccoooorrrrdddd ``Records'' an archive folio containing all the metrics from the currently displayed set of charts, from the current time until recording is explicitly stopped. When FFFFiiiilllleeee////RRRReeeeccccoooorrrrdddd is invoked, a file chooser dialog is displayed to allow the user to specify the path name of the new archive folio. If the directory path to this file does not exist, ppppmmmmcccchhhhaaaarrrrtttt will attempt to create it. It is usually convenient to keep each archive folio in its own directory. ppppmmmmcccchhhhaaaarrrrtttt then forks and execs a ppppmmmmllllooooggggggggeeeerrrr(1) process for each host represented in the current set of charts with a configuration file that matches the metrics and instances currently displayed for each such host. At some later time, the user should invoke FFFFiiiilllleeee////SSSSttttoooopppp RRRReeeeccccoooorrrrddddiiiinnnngggg to terminate the ppppmmmmllllooooggggggggeeeerrrr(1) processes. Note that FFFFiiiilllleeee////SSSSttttoooopppp RRRReeeeccccoooorrrrddddiiiinnnngggg can also be used to check on the progress of the recording without actually stopping it. At any later time, ppppmmmmcccchhhhaaaarrrrtttt can be used to replay the archive folio using the command: ````````ppppmmmmaaaaffffmmmm _f_o_l_i_o rrrreeeeppppllllaaaayyyy''''''''. See ppppmmmmaaaaffffmmmm(1) for further details. FFFFiiiilllleeee////PPPPrrrriiiinnnntttt Pops up a dialog to print either the current chart or all charts to a file or directly to a Postscript printer. FFFFiiiilllleeee////QQQQuuuuiiiitttt Terminates all connections and exits. Also closes the connection to ppppmmmmttttiiiimmmmeeee(1), which will exit if there are no remaining time control clients. VVVViiiieeeewwww////VVVViiiieeeewwww SSSSeeeelllleeeeccccttttoooorrrr Pops up the View Selection dialog to choose a set of charts to display. There are pre-defined views that specify charts for common performance problems as well as your own user-defined views (if any have previously been saved). There are two types of views - _d_y_n_a_m_i_c _v_i_e_w_s and _l_i_t_e_r_a_l _v_i_e_w_s. Dynamic views allow the host to be changed before the charts comprising the view are created. All the pre-defined views (on the left side of the dialog) are dynamic views. Literal views contain references to specific hosts. The target host can not be changed when a literal view is selected. Views saved via the VVVViiiieeeewwwwssss////VVVViiiieeeewwww SSSSaaaavvvveeee dialog are literal views by default. The Section below titled GGGGEEEENNNNEEEERRRRAAAALLLLIIIIZZZZEEEEDDDD PPPPaaaaggggeeee 6666 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEESSSS describes how to change a literal view into a dynamic view. When replaying an archive, you can only show views for metrics contained in the archive. For this purpose, there are ppppmmmmllllooooggggggggeeeerrrr(1) configuration files for the pre-defined views in the files ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....vvvviiiieeeewwww....****. To create an archive containing the metrics required to display any of the pre-defined views, use the command; ccccaaaatttt ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....vvvviiiieeeewwww....**** |||| \\\\ ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ppppmmmmllllooooggggggggeeeerrrr ----TTTT 3333666600000000 vvvviiiieeeewwwwaaaarrrrcccchhhhiiiivvvveeee This will create an archive called vvvviiiieeeewwwwaaaarrrrcccchhhhiiiivvvveeee containing one hour of data for all the metrics in all pre-defined views, sampled at 15 second intervals. VVVViiiieeeewwww////SSSSaaaavvvveeee Pops up a file selector dialog to choose a file to save the configuration of the currently displayed set of charts. This file immediately appears as a user-defined View in the View Selection dialog. The initial directory is set to that specified by the ppppmmmmVVVViiiieeeewwwwUUUUsssseeeerrrrDDDDiiiirrrr, which defaults to ~~~~////....ppppccccpppp. The system view directory is specified by the ppppmmmmVVVViiiieeeewwwwSSSSyyyyssssDDDDiiiirrrr resource, and is not normally over-ridden. EEEEddddiiiitttt////NNNNeeeewwww CCCChhhhaaaarrrrtttt Pops up the Metric Selection dialog to create custom charts. This involves selecting a performance metric, then either adding it to an existing chart, or creating a new chart. EEEEddddiiiitttt////VVVViiiissssiiiibbbblllleeee DDDDaaaattttaaaa PPPPooooiiiinnnnttttssss Allows the number of visible data points (i.e. the ``history'') to be changed using a scaler widget. EEEEddddiiiitttt////CCCChhhhaaaarrrrtttt SSSSttttyyyylllleeee Changes the style of the current chart. Available styles include: lllliiiinnnneeee Draws a single line for each plot. If auto-scaling is not enabled for the current chart, the plot is clipped to the minimum and maximum Y-values. The original unclipped data points are ``remembered'' so that if new scaling parameters are specified then the plot will be clipped accordingly. bbbbaaaarrrr Draws bars side by side for each plot in the current chart. ssssttttaaaacccckkkkeeeedddd----bbbbaaaarrrr Draws bars stacked vertically so that the maximum height of a bar is the sum of the heights of the bars for all plots. aaaarrrreeeeaaaa Same as lllliiiinnnneeee but the area under each plot is filled. This is only really useful for charts which have a single plot, but does have the advantage of greater visibility from a distance. PPPPaaaaggggeeee 7777 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) uuuuttttiiiilllliiiizzzzaaaattttiiiioooonnnn This a special form of ssssttttaaaacccckkkkeeeedddd----bbbbaaaarrrr but the height is always 100%; i.e. the sum of the bars is used to normalize the height of the stacked bar. EEEEddddiiiitttt////LLLLeeeeggggeeeennnndddd Pops up a dialog for the current chart that controls whether the legend is visible or not. EEEEddddiiiitttt////YYYY----AAAAxxxxiiiissss SSSSccccaaaalllliiiinnnngggg Pops up a dialog controlling the scaling parameters of the current chart. If auto-scale is disabled, the user can specify the minimum and maximum Y-axis values. Values outside these ranges will be clipped. If auto-scale is enabled, the minimum Y-axis value is zero and the maximum is the highest Y-value that is visible in any plot in the current chart. EEEEddddiiiitttt////CCCCoooolllloooorrrrssss Pops up a dialog to allow the user to change the color of the plot for an individual metric from the current chart. EEEEddddiiiitttt////DDDDeeeelllleeeetttteeee////DDDDeeeelllleeeetttteeee PPPPllllooootttt Pops up a dialog to allow the user to delete an individual plot from the current chart. EEEEddddiiiitttt////DDDDeeeelllleeeetttteeee////DDDDeeeelllleeeetttteeee CCCChhhhaaaarrrrtttt Deletes the current chart. The most recently created chart becomes the new current chart. EEEEddddiiiitttt////DDDDeeeelllleeeetttteeee DDDDeeeelllleeeetttteeee AAAAllllllll Delete all currently displayed charts and return to the default starting state where only the time axis is displayed. OOOOppppttttiiiioooonnnnssss////SSSShhhhoooowwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll Toggles the visibility of the ppppmmmmttttiiiimmmmeeee(1) time control dialog. The same dialog is also activated by pressing the push-button in the lower left corner of the main window. OOOOppppttttiiiioooonnnnssss////NNNNeeeewwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll Disconnects from the current time control server and connects to a new one, initially as the only client. If ppppmmmmcccchhhhaaaarrrrtttt was the only client of the previous time control server, then that server will exit and remove it's control port. See ppppmmmmttttiiiimmmmeeee(1) for further details. OOOOppppttttiiiioooonnnnssss////LLLLaaaauuuunnnncccchhhh NNNNeeeewwww ppppmmmmcccchhhhaaaarrrrtttt Launches another ppppmmmmcccchhhhaaaarrrrtttt session with shared (synchronized) time controls. In live mode, synchronized ppppmmmmcccchhhhaaaarrrrtttt windows will share a common update interval and timezone setting. In archive mode, synchronized ppppmmmmcccchhhhaaaarrrrtttt windows also share the current archive position and time control mode. PPPPaaaaggggeeee 8888 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS ppppmmmmUUUUsssseeeerrrrHHHHoooossssttttLLLLiiiisssstttt This is a comma separated list of host names. During initialization, ppppmmmmcccchhhhaaaarrrrtttt will add each host to the host option-menu in the metric selection dialog. This particular resource would normally be placed in a user's ~~~~////....XXXXrrrreeeessssoooouuuurrrrcccceeeessss file and contain the list of hosts the user most often monitors. Note that when a ppppmmmmcccchhhhaaaarrrrtttt configuration file is loaded (see ----cccc and the description of the View Selection dialog), the hosts specified in the file will also be added to the metric selection dialog (if not already present). ppppmmmmVVVViiiieeeewwwwUUUUsssseeeerrrrDDDDiiiirrrr The View Selection dialog searches this directory for user-defined views. The default directory is ~~~~////....ppppccccpppp. All files in this directory will be inserted into the user-defined views list in the View Selection dialog. ppppmmmmVVVViiiieeeewwwwSSSSyyyyssssDDDDiiiirrrr The View Selection dialog searches this directory for pre-defined views. The default directory is ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmcccchhhhaaaarrrrtttt. ppppmmmmNNNNaaaammmmeeeeSSSSppppaaaacccceeee The PMAPI name space file - an empty string means use the default PMNS, which is found in the file /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t unless the environment variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is set, in which case the value is assumed to be the pathname to the file containing the default PMNS. ppppmmmmSSSSaaaammmmpppplllleeeeHHHHiiiissssttttoooorrrryyyy The number of data points. This is not changeable at run-time. The default is 120. ppppmmmmVVVViiiissssiiiibbbblllleeeeHHHHiiiissssttttoooorrrryyyy Number of data intervals that are actually visible. Changeable at runtime using the slider in the OOOOppppttttiiiioooonnnnssss////SSSShhhhoooowwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll dialog. The default is 30. ppppmmmmUUUUppppddddaaaatttteeeeIIIInnnntttteeeerrrrvvvvaaaallll Milliseconds between updates. This is changeable at runtime using the textbox in the OOOOppppttttiiiioooonnnnssss////SSSShhhhoooowwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll dialog. ppppmmmmLLLLooooaaaaddddFFFFiiiilllleeee Name of file, if any, to be used to load initial chart configuration. ppppmmmmPPPPrrrriiiinnnnttttFFFFoooonnnntttt Postscript font for output. If not defined, the font is chosen to match the screen font. ppppmmmmCCCClllloooocccckkkkSSSSkkkkeeeewwwwTTTToooolllleeeerrrraaaannnncccceeee See the description for the ----sssstttt command line option (above). PPPPaaaaggggeeee 9999 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) ppppmmmmSSSSccccrrrroooollllllllIIIInnnntttteeeerrrrppppoooollllaaaatttteeee See the description for the ----ssssccccrrrroooolllllllliiiinnnntttteeeerrrrppppoooollllaaaatttteeee command line option (above). ppppmmmmDDDDeeeeffffaaaauuuullllttttCCCCoooolllloooorrrrssss This resource is a comma or space separated list of colors, specifying the default color scheme named #-_c_y_c_l_e.... Each color in the list is either a color name from ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////rrrrggggbbbb....ttttxxxxtttt or a color in any of the XXXX11111111(1) /CIE formats (e.g.####ffffffff0000000000000000 specifies RRRReeeedddd). ppppmmmmMMMMiiiinnnnGGGGrrrraaaapppphhhhHHHHeeeeiiiigggghhhhtttt All charts have the same graph height, but the legend area is variable height depending on the number of plots in each chart. This resource specifies the minimum allowed height of the graph drawing areas. xxxxrrrrttttDDDDoooouuuubbbblllleeeeBBBBuuuuffffffffeeeerrrr avoids flicker in chart updates, but twice as many color table entries are used. xxxxrrrrttttFFFFoooorrrreeeeggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr xxxxrrrrttttBBBBaaaacccckkkkggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr xxxxrrrrttttGGGGrrrraaaapppphhhhFFFFoooorrrreeeeggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr xxxxrrrrttttGGGGrrrraaaapppphhhhBBBBaaaacccckkkkggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr xxxxrrrrttttHHHHeeeeaaaaddddeeeerrrrFFFFoooorrrreeeeggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr xxxxrrrrttttHHHHeeeeaaaaddddeeeerrrrBBBBaaaacccckkkkggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr Various colors; can be changed to suit. Note that xxxxrrrrttttGGGGrrrraaaapppphhhhFFFFoooorrrreeeeggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr and xxxxrrrrttttHHHHeeeeaaaaddddeeeerrrrFFFFoooorrrreeeeggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr default to xxxxrrrrttttFFFFoooorrrreeeeggggrrrroooouuuunnnnddddCCCCoooolllloooorrrr if not specified (likewise for the background colors). Also see ppppmmmmDDDDeeeeffffaaaauuuullllttttCCCCoooolllloooorrrrssss above. xxxxrrrrttttBBBBaaaarrrrCCCClllluuuusssstttteeeerrrrWWWWiiiiddddtttthhhh Controls the width of bars. If set to less than 111100000000 this will restrict the number of visible intervals before the border that is drawn around each bar starts to blend, obscuring the color of the bar. xxxxrrrrttttLLLLeeeeggggeeeennnnddddFFFFoooonnnntttt xxxxrrrrttttAAAAxxxxiiiissssFFFFoooonnnntttt These resources control the legend and axis fonts respectfully. If set to large point sizes ppppmmmmcccchhhhaaaarrrrtttt will compensate with the chart layout. This is useful for viewing charts from a distance (presentations, demos, etc). PPPPaaaaggggeeee 11110000 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) DDDDIIIIAAAALLLLOOOOGGGG GGGGEEEEOOOOMMMMEEEETTTTRRRRYYYY RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS The following resources define the geometry of the various dialogs used in ppppmmmmcccchhhhaaaarrrrtttt. These resources may be used to control the height, width and location of dialogs. By default, the corresponding hhhheeeeiiiigggghhhhtttt and wwwwiiiiddddtttthhhh resources control the height and width geometry settings, and the location settings are left undefined (hence the user manually places each dialog when it is mapped to the screen). mmmmeeeettttrrrriiiiccccSSSSeeeelllleeeeccccttttDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Metric Selection dialog. vvvviiiieeeewwwwSSSSeeeelllleeeeccccttttDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The View Selectin dialog. gggglllloooobbbbaaaallllCCCCoooonnnnttttrrrroooollllDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Global Controls/VCR dialog. ffffiiiilllleeeeSSSSaaaavvvveeeeDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The View Save dialog. aaaarrrrcccchhhhiiiivvvveeeeLLLLooooaaaaddddDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Archive Open dialog. pppprrrriiiinnnnttttDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Print dialog. iiiinnnnffffooooDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll****ggggeeeeoooommmmeeeettttrrrryyyy The Metric Information dialog (invoked from the Metric Select dialog). vvvvaaaalllluuuueeeeDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll****ggggeeeeoooommmmeeeettttrrrryyyy The Metric Value Information dialog (invoked using the right mouse button in a chart). mmmmeeeettttrrrriiiiccccCCCCoooolllloooorrrrssssDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Metric Colors dialog. mmmmeeeettttrrrriiiiccccCCCCoooolllloooorrrrssssDDDDiiiiaaaalllloooogggg****ccccoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Color Chooser dialog (invoked from the Metric Colors dialog). mmmmeeeettttrrrriiiiccccDDDDeeeelllleeeetttteeeeDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Metric Delete dialog. ssssccccaaaalllleeeeCCCCoooonnnnttttrrrroooollllDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Y-Axis Scale Control dialog. lllleeeeggggeeeennnnddddCCCCoooonnnnttttrrrroooollllDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Legend Control dialog. vvvviiiissssiiiibbbblllleeeePPPPooooiiiinnnnttttssssDDDDiiiiaaaalllloooogggg****ggggeeeeoooommmmeeeettttrrrryyyy The Visible Points dialog. PPPPaaaaggggeeee 11111111 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) The default values for these resources (as specified in ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////PPPPmmmmCCCChhhhaaaarrrrtttt) defines the width and height of each dialog, but the X and Y positions are not specified - hence dialogs use interactive placement by default, unless the _d_e_s_k_t_o_p(1) has been configured for random window placement. Consult the XXXX(1) man page for details of the syntax for geometry resources. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE SSSSYYYYNNNNTTTTAAAAXXXX The parser implements a simple grammar as follows; keywords are shown literally, variables are enclosed in angle brackets and optional syntax is enclosed in square brackets. Ellipsis denotes repetition. Blank lines and lines starting with #### are ignored. A new line is expected between each CCCChhhhaaaarrrrtttt and between each PPPPllllooootttt. Case is not significant for keywords. # comment Version <number> [host dynamic|literal] Scheme <schemename> color color ... Scheme ... Chart Style <style> [Scale from <min> to <max>] [Legend off] Plot Color <color> Host <host> Metric <metric> [Instance <instance>] Plot Color <color> Host <host> Metric <metric> [Matching <regex>] Plot ... Chart ... Each line starting with SSSScccchhhheeeemmmmeeee specifies a list of colors comprising the color scheme named <_s_c_h_e_m_e_n_a_m_e>. The default color scheme is named #- _c_y_c_l_e, and is predefined using an XXXX(1) resource (see the ppppmmmmDDDDeeeeffffaaaauuuullllttttCCCCoooolllloooorrrrssss application resource or the ----ddddcccc command line argument). A color scheme declaration extends to the end of the line. Each line starting with CCCChhhhaaaarrrrtttt creates a new chart containing the plots specified on each subsequent line starting with PPPPllllooootttt. If the SSSSccccaaaalllleeee for a chart is not specified, then the chart will use auto-scaling. <_s_t_y_l_e> must be one of ppppllllooootttt, aaaarrrreeeeaaaa, bbbbaaaarrrr, ssssttttaaaacccckkkkiiiinnnngggg or uuuuttttiiiilllliiiizzzzaaaattttiiiioooonnnn. The LLLLeeeeggggeeeennnndddd is on (i.e. shown) by default. <_c_o_l_o_r_s> are specified in the standard XXXX(1) syntax; e.g. ####rrrrrrrrggggggggbbbbbbbb where the red, green and blue components are two digit hex numbers, or the XXXX(1) color database names may also be used. As a special case, if a previously defined color scheme name is used, then the color for the plot will be the next unused color from the that color scheme. Color scheme names take precedence over color names, so care is required not to use names for color schemes which clash with names in the color name database. If all colors in the color scheme have been used, then the list is recycled. Metrics which have a singular instance domain should not specify an instance. If an IIIInnnnssssttttaaaannnncccceeee is given, the <_i_n_s_t_a_n_c_e> name extends to the end of the line (i.e. spaces are allowed, but <_i_n_s_t_a_n_c_e> should not be quoted). If there are multiple instances of the same metric, separate PPPPllllooootttt specifications may be given in order to create plots of only specific instances. Alternatively, if the IIIInnnnssssttttaaaannnncccceeee keyword is missing and the metric does not have a singular instance domain (i.e. there may be multiple instances), then a plot is created for every instance. If PPPPaaaaggggeeee 11112222 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) the keyword MMMMaaaattttcccchhhhiiiinnnngggg is used (instead of IIIInnnnssssttttaaaannnncccceeee), then plots will be created for all instances which have instance names that match the supplied regular expression pattern, <_r_e_g_e_x>. See rrrreeeeggggeeeexxxx(3G) for details about regular expressions. Lines which are likely to create multiple plots from the one PPPPllllooootttt specification would normally use a color scheme for <_c_o_l_o_r> so that each plot is created with a different color. Finally, there should be exactly one line starting with VVVVeeeerrrrssssiiiioooonnnn. If <_n_u_m_b_e_r> is 1111....1111 (or later), then the hhhhoooosssstttt ddddyyyynnnnaaaammmmiiiicccc and hhhhoooosssstttt lllliiiitttteeeerrrraaaallll syntax is parsed (in version 1111....0000 this syntax is ignored). The default is hhhhoooosssstttt lllliiiitttteeeerrrraaaallll, meaning when this configuration file is loaded as a View, the <_h_o_s_t> specifies the actual host for each plot. If the configuration file is hhhhoooosssstttt ddddyyyynnnnaaaammmmiiiicccc, then the <_h_o_s_t> specified for each plot is ignored, instead being replaced by the current host in the View Selection dialog (<_h_o_s_t> in this case is normally ****). GGGGEEEENNNNEEEERRRRAAAALLLLIIIIZZZZEEEEDDDD CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEESSSS Configuration files saved through the VVVViiiieeeewwww SSSSaaaavvvveeee option of the VVVViiiieeeewwwwssss menu contain the host and metric instance information from the chart at the time the view is saved. These specific configuration files can be tranformed into more general views by the following procedure: 1. Replace lllliiiitttteeeerrrraaaallll by ddddyyyynnnnaaaammmmiiiicccc in the VVVVeeeerrrrssssiiiioooonnnn line. 2. Replace the <_h_o_s_t> by an asterisk (*) in each PPPPllllooootttt line. Strictly speaking this is not necessary, but it improves the readability of the configuration file. 3. If there are multiple PPPPllllooootttt lines for the same metric, but with different IIIInnnnssssttttaaaannnncccceeee choices, you may choose to replace these by a single PPPPllllooootttt line with a CCCCoooolllloooorrrr of ####----ccccyyyycccclllleeee (is is suggested that all CCCCoooolllloooorrrr specifications in the same CCCChhhhaaaarrrrtttt are also changed to ####----ccccyyyycccclllleeee), and the IIIInnnnssssttttaaaannnncccceeee specification is either removed or replaced by a MMMMaaaattttcccchhhhiiiinnnngggg specification. For example, the following might be saved: Version 1.2 host literal Chart Style plot Plot Color #ffff33 Host gonzo Metric cisco.rate_in Instance wanmelb:s0 Plot Color #3380ff Host gonzo Metric cisco.rate_in Instance wanptg:e0 Plot Color #ff3333 Host gonzo Metric cisco.rate_in Instance wanptg:s0 Chart Style plot Plot Color #ffff33 Host gonzo Metric cisco.rate_out Instance wanmelb:s0 Plot Color #3380ff Host gonzo Metric cisco.rate_out Instance wanptg:e0 Plot Color #ff3333 Host gonzo Metric cisco.rate_out Instance wanptg:s0 Following the procedure above, this might be transformed to produce: Version 1.2 host dynamic Chart Style plot PPPPaaaaggggeeee 11113333 PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) PPPPMMMMCCCCHHHHAAAARRRRTTTT((((1111)))) Plot Color #-cycle Host * Metric cisco.rate_in Matching .*:s[0-9]* Chart Style plot Plot Color #-cycle Host * Metric cisco.rate_out Matching .*:s[0-9]* The end result is a view that is not only useful on any host with the Cisco PMDA installed, but the plotted instances will include all serial interfaces that the Cisco PMDA has been configured to monitor. FFFFIIIILLLLEEEESSSS ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////* default PMNS specification files ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmcccchhhhaaaarrrrtttt the default directory for pre-defined Views ~~~~////....ppppccccpppp the default directory for user-defined Views ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....vvvviiiieeeewwww....**** ppppmmmmllllooooggggggggeeeerrrr(1) configuration files for pre-defined views ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////PPPPmmmmCCCChhhhaaaarrrrtttt application defaults CCCCAAAAVVVVEEEEAAAATTTT There is currently no way to load a different name space after ppppmmmmcccchhhhaaaarrrrtttt has started. This presents a problem when the name space on the local host does not adequately represent the set of metrics available on a remote host. This issue will be addressed in a future release of the Performance Co-Pilot (PCP). If the X11 option ----ggggeeeeoooommmmeeeettttrrrryyyy specifies a window height but no configuration file is specified (----cccc), then ppppmmmmcccchhhhaaaarrrrtttt ignores the requested height for the initial window. This is necessary because the height of the time scale graph area at the bottom of the main window is derived from the vertical size of the axis font (see the application resource xxxxrrrrttttAAAAxxxxiiiissssFFFFoooonnnntttt). If the XXXX(1) display is not ``GL-Capable'', then ppppmmmmcccchhhhaaaarrrrtttt can still be used but the application resource ****uuuusssseeeeGGGGllll needs to be set to FFFFaaaallllsssseeee. This can be done from the command line, e.g. ppppmmmmcccchhhhaaaarrrrtttt ----xxxxrrrrmmmm """"****uuuusssseeeeGGGGllll:::: FFFFaaaallllsssseeee"""" or via any of the standard resource manager mechanisms. SSSSEEEEEEEE AAAALLLLSSSSOOOO XXXX(1), ddddkkkkvvvviiiissss(1), mmmmppppvvvviiiissss(1), ppppmmmmaaaaffffmmmm(1), ppppmmmmccccdddd(1), ppppmmmmiiiieeee(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmllllooooggggggggeeeerrrr(1), ppppmmmmttttiiiimmmmeeee(1), ppppmmmmvvvvaaaallll(1), ppppmmmmvvvviiiieeeewwww(1), ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3) and eeeennnnvvvviiiirrrroooonnnn(5). DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS Are intended to be self explanatory. PPPPaaaaggggeeee 11114444